home *** CD-ROM | disk | FTP | other *** search
/ 17 Bit Software 3: The Continuation / 17-Bit_The_Continuation_Disc.iso / amigan / amigan 15 / iff2ps / iff2ps.doc < prev    next >
Encoding:
Text File  |  1994-01-27  |  8.0 KB  |  180 lines
  1.  
  2.  
  3.  
  4.        IFF2PS - A PROGRAM TO CONVERT IFF FILES TO POSTSCRIPT
  5.  
  6.                           VERSION 1.2
  7.  
  8.                       COPYRIGHT (C) 1987
  9.                  WILLIAM MASON AND SAM PAOLUCCI
  10.                       ALL RIGHTS RESERVED
  11.  
  12.  
  13.      IFF2PS is a shareware program for the AMIGA(TM) which converts
  14. IFF ILBM (interleaved bit map) files such as those created by Deluxe
  15. Paint(TM) to PostScript(TM) image files for half-tone printing on laser
  16. printers, such as the Apple LaserWriter(TM), which support PostScript.
  17. This version supports IFF ILBM files in all of the standard AMIGA view
  18. modes (i.e., high resolution, interlace, and HAM (hold and modify)). 
  19.  
  20.      As noted above, IFF2PS is a shareware program.  Shareware is a
  21. concept wherein computer software can be distributed in a manner which
  22. allows potential users to try out the software without having to
  23. purchase it initially.  If you become a regular user of this program,
  24. please become a registered owner by contributing to its continued
  25. development and improvement.  Details are given below in the section
  26. entitled "SHAREWARE". 
  27.  
  28.      As shareware, this program is not in the public domain.  It may
  29. be distributed free of charge to anyone by anyone as long as it is
  30. accompanied by this document.  IFF2PS may not be distributed for a fee
  31. with the permission of the authors.  An exception is made for
  32. non-profit user's groups which my charge a reasonable fee in order to
  33. defray the cost of duplication and distribution. 
  34.  
  35.  
  36. USAGE:
  37.  
  38.      This version of IFF2PS operates only from the CLI. It requires
  39. that the stack be set to at least 8000 (i.e., Stack 8000). It has two
  40. possible modes of operation.  There is a UN*X-like mode with command
  41. line arguments entered on the execution line and an interactive mode
  42. where the user is prompted for the required information. 
  43.  
  44.      In the first mode, the execution line takes the form:
  45.  
  46.      iff2ps -i iffname [-o output] [-g #grays] [-n] [-c #copies] [-?]
  47.  
  48. where the "-i" keyword is required and is followed by "iffname" the
  49. name of the IFF input file.  The parameters in brackets are optional
  50. and are defined as follows: 
  51.  
  52.        OPTION                       DESCRIPTION
  53.        
  54.     -o  output     Send PostScript data to "output".  This may be a
  55.                    file name or "ser:".  If "ser:" is used, it is
  56.                    assumed that the AMIGA has been PROPERLY connected
  57.                    via the serial port to the laser printer.  (Note:
  58.                    See section on connecting printers below.)  If this
  59.                    option is omitted, the output will be sent to a file
  60.                    whose name is created by appending a ".p" to the input
  61.                    file name.  This file will reside in the same directory
  62.                    as the input file.
  63.  
  64.     -g  #grays     Number of gray shades to be used in the half-toned image.
  65.                    There are only four possible values for the number
  66.                    of gray shades: 2, 4, 16, 256.  If this option is omitted,
  67.                    the next number greater than or equal to the number
  68.                    of colors in the IFF file will be used.  For example:
  69.                    a 320 by 200 pixel by 5 bit planes (32 colors) picture
  70.                    would default to 256 gray shades while a 640x400x4 
  71.                    (16 color) picture would default to 16 gray shades.
  72.  
  73.                    If an image contains a pure white color, it will be 
  74.                    rendered as pure white in the half-toned print.  In 
  75.                    order to get a half-toned white (99 percent of pure 
  76.                    white) instead of pure white, enter the number of 
  77.                    gray shades as a negative number (e.g., -g -256).
  78.  
  79.                    Special effects (and smaller output files) can be obtained
  80.                    by choosing fewer gray shades than colors in the original
  81.                    picture.  Choosing 2 shades will result in a high contrast
  82.                    image while choosing 4 shades for a picture with
  83.                    greater than 4 colors will result in a posterized effect.
  84.  
  85.     -n             Negative image.  Can be used with any choice of the number
  86.                    of gray shades.  
  87.  
  88.     -c  #copies    Number of copies.  The practical upper limit on the number
  89.                    of copies is governed by the number of sheets which the
  90.                    printer paper tray will hold.  The default value is 1.
  91.                    If you want multiple copies of the same image, use
  92.                    this option instead of running the code multiple times
  93.                    as it is orders of magnitude faster.
  94.  
  95.     -?             Produces a synopsis of usage when used with no other
  96.                    parameters.
  97.  
  98.      The second mode of execution is an interactive mode which is
  99. initiated by typing only the program name from the CLI. The program
  100. will then prompt for the parameters which are described above.
  101.  
  102.  
  103. ADDITIONAL OUTPUT INFORMATION:
  104.  
  105.      The size of the PostScript format output file created by IFF2PS
  106. can be roughly calculated from the equation 
  107.  
  108.                  SIZE = WIDTH * HEIGHT * B / 4
  109.  
  110. where SIZE is the size in bytes, WIDTH and HEIGHT are the respective
  111. width and height (in pixels) of the IFF picture and B=(1, 2, 4, 8)
  112. respectively as g=(2, 4, 16, 256).  For example, a 320x200x5 picture
  113. with 32 colors represented by a range of 256 shades of gray would
  114. result in a PostScript file of approximately 128K bytes while a high
  115. contrast image of the same picture would require only about 16K bytes.
  116. A 640x400x4 HIRES picture with 16 colors represented by 16 gray shades
  117. or a 320x400 HAM picture using 256 gray shades to represent 4096
  118. colors will result in a file more than 256K long. 
  119.  
  120.      There are two possible solutions for handling large files.  One
  121. is to go directly to the serial port by specifying "ser:" as the
  122. output option in which case no file is saved.  Another is to save
  123. the files to disk and compress them using a file compression utility. 
  124. Experience has shown that a typical PostScript image file will
  125. compress by about 70-80 percent. 
  126.  
  127.      In order to send a previously saved PostScript file to the
  128. printer use either the CLI copy or type command in the form: 
  129.  
  130.           copy pfile to ser:
  131. or
  132.           type pfile to ser:
  133.  
  134. where "pfile" is the name of the PostScript file.
  135.   
  136.  
  137. PRINTER CONNECTIONS:
  138.  
  139.      Incorrect connection of a laser printer to the serial port on the
  140. AMIGA could cause serious damage to the printer, the computer or both.
  141. Make sure that you obtain complete information about serial
  142. connections for both the AMIGA and the laser printer you plan to use
  143. before making the connection.  Note particularly, that pins 14, 21, and
  144. 23 on the AMIGA serial connector are designed to supply external power
  145. and should definitely not be connected to any current laser printer. 
  146. If you do not understand how to make the proper connection between the
  147. AMIGA and the laser printer, get help from a knowledgeable person. 
  148.  
  149.      It is also important to set the AMIGA preferences to correspond
  150. to those required by the laser printer.  For example, the Apple
  151. LaserWriter requires a setting of 9600 baud, 8 bits, no parity,
  152. xon/xoff. 
  153.  
  154.  
  155. DISCLAIMER:
  156.  
  157.      This program is distributed WITHOUT ANY WARRANTY.  The author
  158. accepts no responsibility for the usefulness or accuracy of this
  159. program.  As stated above, this program may only be distributed when
  160. accompanied by this document. 
  161.  
  162.  
  163. SHAREWARE:
  164.  
  165.      If you find this program useful and continue to use it, please
  166. become a registered owner by sending $15.00(US) to:
  167.  
  168.                      William Mason
  169.                      1709 Timberlake Circle
  170.                      Lodi, CA  95242
  171.  
  172.      As a registered owner, you will receive a disk containing the
  173. latest version of the program along with a more complete user's manual
  174. and several examples (both hardcopy and as files).  You will also be
  175. put on a mailing list to receive information about bug-fixes, updates,
  176. and enhancements.  Please send any comments, either pro or con which
  177. you may have about the program to the author so that future
  178. improvements can better reflect the needs of the users. 
  179.  
  180.